home *** CD-ROM | disk | FTP | other *** search
/ Aminet 1 (Walnut Creek) / Aminet - June 1993 [Walnut Creek].iso / aminet / dev / cross / adev11_1_2.lha / readme < prev    next >
Text File  |  1992-12-21  |  9KB  |  176 lines
  1. /*
  2.  * Copyright 1992 Stan Burton
  3.  *
  4.  * Permission to use, copy, modify, distribute, and sell this software
  5.  * and its documentation for any purpose is hereby granted without fee,
  6.  * provided that the above copyright notice appear in all copies and
  7.  * that both that copyright notice and this permission notice appear in
  8.  * supporting documentation, and that the name of Stan Burton not be used
  9.  * in advertising or publicity pertaining to distribution of the software
  10.  * without specific, written prior permission.  I make no representations
  11.  * about the suitability of  this software for any purpose.  It is
  12.  * provided "as is" without express or implied warranty.
  13.  *
  14.  * THE ABOVE-NAMED DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
  15.  * INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS.  IN NO EVENT
  16.  * SHALL STAN BURTON BE LIABLE FOR ANY SPECIAL, INDIRECT OR
  17.  * CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
  18.  * DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
  19.  * TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE
  20.  * OF THIS SOFTWARE.
  21.  *
  22.  * Author:
  23.  *        Stan Burton
  24.  *
  25.  *        1978 26 St. SE
  26.  *        Medicine Hat, AB, CANADA
  27.  *              T1A 2G8
  28.  */
  29.  
  30. SOME OF THESE PROGRAMS REQUIRE AMIGADOS 2.0
  31.  
  32. slink requires V2.0, slink1.3 is a slower AmigaDOS V1.3 compatible
  33. replacement for slink.  All other programs are V1.3 and 2.0 compatible.
  34.  
  35.  
  36. INSTALLATION
  37.  
  38. Installation is simple. If you are reading this, and logically you must
  39. be, then step 1 is done.
  40.  2.  The directory containing this file and the other files unpacked from
  41.        the archive should be added to your path.
  42.  3.  Assign ADev11: to this directory.  This is required mainly for the
  43.        C compiler when released.
  44.  4.  Read the docs! I know you won't until you run into trouble, but make
  45.        sure you have read them before you come to me for help.
  46.  
  47.  
  48. COMMON PROBLEMS
  49.  
  50. slink reports unknown hunk type
  51.     the assembler may have been aborted leaving a partial file
  52.     the assembler source file may have code outside of a segment
  53. sc11 reports a problem in byte_length
  54.     certain errors in the C source file may cause SC11 to emit
  55.       68000 instructions.  For example
  56.         char c, *chr_ptr;
  57.         c = *(char *)*chr_ptr;
  58.     this may be a legitimate bug.  If there is nothing wrong
  59.       with the C source, reduce the source file as much as
  60.       possible and send it to me.
  61.  
  62.  
  63. RELEASE CHANGES
  64.  
  65. KNOWN BUGS ---------------------------------
  66. SAsm - a DC.l with a symbol can cause assembler to hang
  67. the docs should have elaborative error message descriptions
  68. SDis requires at least one non-executable byte after the last executable
  69.   opcode in memory or it will not print out the disassembled data
  70.  
  71. 1.2 ----------------------------------------
  72. HCload was reworked in many ways by its original author Ron Eirich.
  73. slink - added a new map mode to the map output.  This displays where, in
  74.   memory, all the hunks from all the modules were placed.
  75. SDis was in far worse shape than I knew.  Many bug fixes and improvements.
  76. sasm mishandled direct references to XREF'd symbols by instructions
  77.   having a prebyte
  78. slink reports of address out of range now include the hunk relative
  79.   address AND the module name AND the absolute address
  80. SAsm - use of an EQUated symbol as the indexed offset or direct address
  81.   of a BSET or BCLR could, in some cases, cause an unusable .o file
  82.   to be produced.
  83. lib11.lib new functions for printing in octal are __put_oct_str_sm,
  84.   __put_oct_str, __put_oct_sm,  __put_oct.
  85. lib11.lib all put_functions now use a symbol called __z_blank that is
  86.   a leading zero blanking (lzb) flag/counter.  Its value is the number of
  87.   leading digits that you want to consider using lzb on.  For example,
  88.   these values printed with _put_asc (a word (5 digit) routine)
  89.   __z_blank | value = 99 | value = 9 | value = 0
  90.   ----------|------------|-----------|----------
  91.        3    |    99      |    09     |    00
  92.        4    |    99      |    9      |    0
  93.        5    |    99      |    9      |
  94.   Normally with a 5 digit routine you would use __z_blank = 4;
  95. lib11.lib sm functions __put_asc_sm, __put_hex_sm, __put_asc_str_sm and
  96.   __put_hex_str_sm now accept the value in the B register.  There are
  97.   new functions __put_asc_usm, __put_asc_str_usm and.
  98. SAsm - fcb and fdb did not treat constants the same as DC.b, particulary
  99.   with respect to symbols and XREFs.
  100. SAsm - fixed a long standing bug in branches to labels in the second or
  101.   later sections of a segment within a module.  This could have produced
  102.   incorrect code in some cases in others it would appear as a branch out
  103.   of range error.  This also affected the use of the '.' symbol.
  104. lib11.lib all functions are now preceeded by __ (assembler level). Done
  105.   for compatibility with C environment.
  106. lib11.lib the functions put_asc, put_asc_sm, put_asc_u, put_hex and
  107.   put_hex_sm now modify the X register.  There are also new versions
  108.   put_asc_str, put_asc_str_sm, put_asc_str_u that put the result in the
  109.   string pointed to by the X register input.
  110. SAsm now accepts the .z force on XREF and SEG.  This causes all symbols
  111.   defined by such an XREF or declared in such a segment to use zero page
  112.   addressing where applicable.  At the same time the restriction on
  113.   automatic generation of page zero references with constant (not symbolic)
  114.   addresses is lifted.
  115. slink has been changed to apply special treatment to segments with the
  116.     name IDATA.  (see docs for more details)
  117. SAsm reported the wrong version number while running
  118. SAsm undefined symbols were reported obliquely, due to a change in R1.1 I
  119.     believe.
  120. SAsm would not allow a symbol to be XDEF'd after it was defined.
  121. SAsm an error resulting from a change just prior to the original release
  122.     made it impossible to successfully reuse a segment within the same
  123.     source file.
  124. SAsm (HC11) has been modified to accept three new pseudo-mnemonics.  They
  125.     are ANDD, EORD, ORD from the 68HC16 instruction set.  They produce, in
  126.     the case of ANDD, an ANDB followed by an ANDA.  Therefore the result
  127.     is correct but only the N bit of the CCR flags is correct.  The
  128.     mnemonics are valid with all HC11 addressing modes.  This change was
  129.     made to prepare for the C compiler and was done in the assembler
  130.     because it could not be done with macros.
  131. 1.1 ----------------------------------------
  132. SDis became confused if the S-record file to be dis-assembled contained a
  133.     value for address FFFF. This would usually result in a crash.
  134. SDis default for (y/N) question would default to Y instead
  135. SAsm failed to recognize that a negative number or expression result >= -128
  136.     could fit into an 8 bit immediate operand resulting in an illegal
  137.     addressing mode error for instructions such as this.
  138.     ldab    #1-2
  139. SAsm - Minor improvement in pass handling under special conditions
  140. SAsm - Unary operations and binary operations involving a single XREF'd symbol
  141.     and an operator other than addition are not legal, but were not detected
  142.     by the assembler and produced incorrect code.
  143. It was not noted anywhere in the documents that some of the programs require
  144.     AmigaDOS 2.0.  Now only slink does and there is a slink1.3 replacement
  145. slink was accessing memory on an odd boundary which would cause a crash on
  146.     68000 68010 processors
  147. The 68HC11 registers include file 68HC11.inc is now included in the release.
  148.     It is not quite complete yet ... as time permits.
  149. A new utility, MHex, has been added which allows conversion of S record
  150.     files to straight binary.  The source is also included in case you have
  151.     a particular format requirement.  I would appreciate receiving any such
  152.     conversions and I will try to make one grand unified utility out of them.
  153. A simple monitor program is provided, along with source, I like it because
  154.     its extensible command set allows me to easily develop command driven
  155.     programs.
  156. New library functions for printing values as hex ascii are available.
  157. HCload was modified to work with any serial-type device and any unit number.
  158. Two of the listed library functions were somehow left out of the library.
  159.  
  160. 1.0 ----------------------------------------
  161. SAsm, slink and slib now handle 68HC16 mnemonics and addressing modes as
  162. far as I have been able to test.  I do not have a 68HC16 processor and
  163. have relied on Motorola printed documents.
  164.  
  165. The docs files other than the .ps file are probably out of date.  They are
  166. included only for those who don't have access to a postscript printer or
  167. converter.
  168.  
  169. I can be reached at:
  170. internet sburton@dres.dnd.ca      <= NOTE: change
  171. BIX      sburton
  172. mail     Stan Burton
  173.          1978 26 St. SE
  174.          Medicine Hat, AB CANADA
  175.          T1A 2G8
  176.